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PART 12 

CHAPTER 1 

INTRODUCTION TO THE 
PERIPHERAL INTERCHANGE PROGRAM (PIP) 

The Peripheral Interchange Program (PIP) performs transfers of data files from 
standard PDP-11 I/O devices to other standard PDP-11 I/O devices and performs simple 
editing and control functions as well. PIP handles all standard data formats used 
in the DOS/BATCH system. 

The major features provided by PIP follow. 

Transfer a file or group of files from one device to another in 
either linked or contiguous format (refer to Section 12-3.1.4). 

Merge a group of input files into a single (new) output file. 

Allocate a contiguous file on disk or DECtape. 

Rename an existing file. 

Cause an input file having the same name as a file on the output 
device to replace that output file. 

Delete a file or group of files. 

Selectively perform an operation on each file of a group of files. 

Change the protection code on a file. 

Print filename, file size, creation date, and protection code of each 
file in a disk, DECtape, cassette, or magtape directory. 

Print a listing of the filenames on disk, DECtape, cassette, or 
magtape directory. 

List the number of free blocks remaining on the device specified. 
Zero (initialize) a disk (except RP03) , DECtape, cassette, or magtape. 
Perform fast copy and/or verify operations for DECtape. 
Perform read-after-write verification for cassette tape. 

1.1 CALLING PIP 

The user must be logged into DOS/BATCH before running PIP. Any previous program in 
core must be removed with the KILL command. (The user should be familiar with the 
operating system commands before attempting to use PIP; particularly the RUN, LOGIN, 
KILL, and FINISH commands.) 

In response to the DOS/BATCH dollar sign character , the user can type the RUN PIP 
command. For example: 

$RUN PIP 

PIP Vxx (xx is PIP version number) 
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Following the RUN command, PIP is called into core, after which it prints its version 
number and a number sign. The number sign indicates that PIP is ready to accept a 
command string. Following completion of a command, PIP prints another # character 
and awaits further commands. 
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PART 12 

CHAPTER 2 

COMMAND STRINGS 

All commands to PIP are processed by the operating system's Command String 
Interpreter (CSI) . This ensures a uniform command format among the various system 
programs operating under DOS/BATCH. This chapter briefly describes the command 
string format of PIP. 

2.1 GENERAL COMMAND STRING FORMATS 

The most general format of a PIP command string is 

output file<input file(s) 

where a single input or output file is completely specified by the following format. 

dev : f ilnam. ext [uic] 
Example: 

DT0 : MACRO . OB J [ 200 , 200] 

Either an output or an input file specification can be followed by a switch speci- 
fication in the command string. A switch specification indicates that some special 
PIP action is to be performed. (See Appendix J for a list of PIP switches.) The 
switch specifications have two forms: 

/sw 



/sw:n 



where 



/ signals a PIP switch specification. 

sw indicates the two letter switch code. 



:n 



indicates a decimal or octal value or, in some cases, 
a one or two letter code. 
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PIP commands can take a variety of formats, depending upon the action desired. Some 
PIP actions are caused when a switch is the only specification in the command string. 
Other PIP actions are caused by a file specification followed by one or more switch 
specifications in the command, string. Examples of typical command strings are shown 
throughout this part of the handbook. 

2.2 DEVICE SPECIFICATION 

The device specification consists of two letters, followed where necessary by an 
octal digit indicating one of multiple units, and terminated by a colon. (The 
standard device specifications are shown in Appendix C.) An octal digit is required 
in the device specification to distinguish between units on multiple-unit devices. 
For example, DTI: and DT2: could be used to specify two DECtapes on the same con- 
troller. When no digit is indicated for a device, unit is assumed by the system. 

When no device is specified for a file, the desired device is assumed to be the 
last device specified on that side (input or output) of the angle bracket (<) . For 
example : 

£DK1 : <DT1 :FILEl ,FILE2 
where FILEl and FILE2 are on DECtape unit 1. 

When no device has been specified in the command, the system disk is assumed to be 
the default I/O device (except for /DI, /BR, and /FR switches, where the terminal 
is the default output device and the system disk is the default input device) . For 
example, /DI will list the current user's system disk directory on the terminal. 

2.3 FILENAME SPECIFICATION 

A filename specification consists of from one to six letters or digits or an 
asterisk. All characters in excess of six are ignored. The asterisk feature is 
described in Section 12-2.5. Examples of filenames are shown below. 

SEVENLE is interpreted as SEVENL 

A34B 

FILE 

* indicates all (filenames or extensions) 

Null fields in a command are ignored. 
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*SY:<DKl:A,,,B 



This command causes files A and B to be read from the DK1: disk to the system disk 
as if the superfluous commas were not present; i.e., filenames, are separated by a 



comma. 



2.4 FILENAME EXTENSION SPECIFICATION 



The filename extension specification consists of a period followed by one to three 
letters or digits, or an asterisk. The asterisk feature is described in Section 
12-2.5. Extensions may be used to specify the format in which a certain file is 
stored, the version of a particular file, or any other information the user desires, 
Examples of filenames used with filename extensions are shown below. 



F0RT.1A 

ABC. PAL 

FILE.TMP 

MODS. 001 

MODS. 002 

MAT.* all files with the name MAT 

Filename extensions, where associated with a filename, must be used to specify that 
particular file, unless the asterisk feature is used. A filename extension may not 
be used without a filename (except with an asterisk substituted for a filename, as 
described below) . 

2.5 ASTERISK FEATURE 

The asterisk (*) character can be used in a command string to replace either the 
filename or filename extension specification or the user number or user group num- 
ber in the UIC. The asterisk is interpreted as all files with the filename or 
filename extension indicated or all users with the user number or user group number 
specified. For example: 

*- TMP indicates all files with the extension .TMP 

FILE.* indicates all files with the name FILE 

t*'f!3] indicates all users in user group 13 

[10,*] indicates all user groups with user number 10 

The asterisk can appear in both positions: 



which denotes all files on the specified device belonging to the user identification 
code specified (or the current user UIC if no UIC is specified) . 
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Except where noted, the asterisk feature can be used in transfer operations, directory 
listing operations, deletion operations, and rename operations. 

PIP can reference all files with null extensions through use of the asterisk feature. 
For example, to delete all files with null (no) extensions, use the following 
command . 

#*./DE 

Explicit noncurrent UIC specification and/or the asterisk feature are allowed in the 
UIC field for functions that are not explicitly prohibited by the other user. 

If the user attempts to transfer a series of files (with the *) in which one has a 
protection code that does not allow transfer, a fatal Monitor error will result when 
PIP attempts to transfer that file, and successive files designated for transfer in 
that command string will not be transferred. 

If a file appears on disk or DECtape with a name not acceptable to the CSI, it 
must be deleted using the * feature.. For example, 

ABC. A (2 spaces in extension) 

is not acceptable and should be deleted. 

ABC . */DE 

The above works unless the file is locked; in which case it must be unlocked. See 
Section 12-4.5. 

To copy files from one device to another using the *, the * must be in the input 
field of the command string. For example: 

devl:<dev2:*.* 

or 

devl:<dev2:*.PAL 

When transferring files, the * cannot be specified in the output field of the 
command string. 
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2.6 SWITCH SPECIFICATIONS 

The switch specification consists of a slash followed by two letters, and is 
optionally followed by a value specification of octal or decimal digits or one or 
two letters separated from the switch code by a colon. Switch names can be of any 
length; but, only the first two characters are significant. Table 12-1 lists the 
PIP switches. 

Nontransfer operations in PIP are selected by use of switches. If more than one 
switch is used, each switch is preceded by a slash. A summary of the switch options 
is in Appendix J. 

When present, a switch must follow any dataset specification; that is, a switch 
cannot appear before the filename, extension, or UIC of the file on which the switch 
is to operate. However, some switches may be specified without any file specifi- 
cation. 

Some options require a numeric value to be associated with the switch. Whether 
the value is octal or decimal depends upon the switch. For example: /PR is 
the switch to change the file protection code. The new protection code is preceded 
by a colon. 

#DT1: ABC/PR: 155 



This command changes the protection code of file ABC on DECtape unit 1 to 155. 
Refer to Section 12-3.6 for a description of protection codes and their uses. 

In general, PIP switch options can be grouped into two categories: action switches 
and qualifying switches. Action switches are generally associated with some action 
Or operation. One one action switch can be used in any one PIP command. The 
action switches follow. 



/AL 


Allocate 


/BR 


" Brief Directory 


/DE 


Delete 


/DI 


Directory 


/EN 


Enter 


/FC 


Fast Copy 


/FR 


Free 


/PR 


Protect 


/RE 


Rename 


/RU 


Rewind and Unload 


/RW 


Rewind 


/SU 


Supersede 


/UN 


Unlock 


/VE 


Verify 


/ZE 


Zero 
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Qualifying switches are used to give PIP particular information about how to per- 
form an operation. These switches can be used in conjunction with other switches 
in a single command string. The qualifying switches follow. 



/CK 


Checksum 


/CO 


Contiguous 


/FA 


Formatted ASCII 


/FB 


Formatted Binary 


/IN 


Inspect 


/RW 


Rewind 


/SU 


Supersede 


/UA 


Unformatted ASCII 


/UB 


Unformatted Binary 


/VE 


Verify 


/VW 


Verified Write 



Another type of distinction that is made among switches is that some can be used 
alone, some operate upon a single file designation, and some require both an input 
and an output specification. 

Table 12-1 

PIP Switches 



Used 
Alone 



/BR 
/CK 
/DI 
/EN 
/FR 
/ZE 



Used with One or More 
File Designations 



/M 
/BR 
/CK 
/DE 
/DI 
/EN 
/FR 
/IN 
/PR 
/RE 
/SU 
/UN 
/VW 
/I2E 



Used with Both an Input and 
Output Designation 



/BR 
/CK 
/CO 
/DI 
/FA 
/FB 
/FR 
/PR 
/RE 
/RW 
/UA 
/UB 
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PART 12 

CHAPTER 3 

FILE MANIPULATION 



3.1 FILE TRANSFERS 



The transferring of files between devices is a primary function of PIP. PIP uses 
the device independent features of the operating system and can either copy a file 
directly onto another device or merge several files from the same or different 
devices into a single file on one device. 

3.1.1 File Copy Operation 

In the simplest case, PIP can transfer a file from one peripheral onto another. 

For example, to list a file, transfer a copy of the file to the line printer, as 

shown here. 

#LP:<DT2:FILEl.PAL where FILEl.PAL is On DECtape 
#LP:<MT1:FILE2.PAL where FILE2.PAL is on magtape 
#LP:<FILE3.PAL where FILE3.PAL is on the system disk 



The following command transfers the data on a paper tape from the high-speed reader 
and creates a file named INPUT. TST on the system disk. 

#INPUT.TST<PR: 

The following command duplicates a paper tape. 
£PP:<PR: 

There can be only one output file designation in a PIP command, although there can 
be any number of input files (limited only by the terminal line length) . For 
example, to copy three files (ONE. PAL, TWO. PAL, and THREE. PAL) from the system disk 
onto DECtape unit 0, type the following command. 

#DT : <ONE . PAL , TWO . PAL , THREE . PAL 

In the case shown above, the files are copied directly to DECtape unit 0, using 
the same filenames as on disk. 

In order to change a filename, the RENAME (/RE) switch can be used. 

#DK : <DT1 :FILE1 , PR: ABC ,MT : DEF .001 
#DAVE1/RE<FILE1 
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The first command transfers three files onto the RKJL1 disk unit 0; FILEl from 
DECtape unit 1, ABC from the paper tape reader, and DEF.001 from magtape unit 0. 
Each file retains its original name. Note the ability to indicate the name of a 
file from the high-speed paper tape reader. The second command renames the file 
FILEl on DK0: to DAVEl. 

3.1.2 Fast Copy and/or Verify Operations 

The fast copy (/FC) and verify (/VE or /FC/VE) operations are applicable only to 
DECtape. Input and output device types must be the same; unit numbers must be 
different. The S26^ or S231 error message will result if the preceding two condi- 
tions are not met. The format of these operations is illustrated in the three 
command strings shown below. 

#DT1:<DT2:/FC/VE 



or 



or 



#DT1:<DT2:/FC 



#DT1:<DT2::/VE 



AC does a block-by-block transfer, unlike a normal transfer at the file level. 
PIP uses the largest amount of core memory available; consequently, the larger 
the main memory, the faster the operation. On 28K machines, for example, a 
DECtape can be copied in about two minutes; verifying it takes two and a quarter 
minutes. 

The verify operation as shown above can be performed alone. If the data on the two 
devices differ, a message indicating the block and word in disagreement is printed 
at the console in the following octal format. 

Block Word 
N M 

3.1.3 File Merge Operation 

When there are several input files involved in a transfer, the files can be trans- 
ferred individually, as the previous examples illustrate, or they can be merged 
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into a single output file. When no output filename is specified on the output 
device, input files are copied without being combined. 

£DT3 : <ABC , DT2 : RASP , PR : DEF 

Three files are copied onto DEC tape unit 3; one from the system disk, one from 
DECtape unit 2, and one from the high-speed paper tape reader. Each retains the 
same name given on the input side. 

When a filename is specified on the output device, all input files are combined to 
create a single new output file. In order to combine the three files shown above 
into a single file named MERGE, the following command is used. 

* #DT3 : MERGE<ABC , DT2 : RASP , PR : DEF 

Numerous variations on this operation are possible. One or more of the input 
files can be specified as being under another UIC, input files can be on the same 
or different devices, etc. 

An operation to merge a single file is equivalent to creating another copy of that 
file with a different name. The command 

£ABC<DT1:FILE1 
takes FILE1 on DECtape unit 1 and puts in on the System disk under the name ABC. 
3.1.4 File Transfer Modes 

The modes of transfer are either formatted or unformatted, either ASCII or binary. 
Refer to Part 3, the DOS/BATCH Monitor, for further details on the modes of 
transfer. 

In .PIP, the mode of transfer of any file is determined by the format switch specified 
in the command string. If a format switch is not specified in a command string, 
the mode assumed for the transfer is unformatted binary or image mode (unformatted 
ASCII if either device does not support binary). This means,, for example, that 
files transferred from paper tape without a mode specification include blank 
frames, leader and trailer tape. A switch specified in the command string may 
be used to force a particular mode of transfer. The switches that specify format 
are /FA, /FB, /UA, and /UB. Only one type of format switch can be specified on one 
side of a command. The switch can be used with both input and output files. For 
example, to transfer the files ABC. DAT and ABC.TST in formatted binary mode, use , 
either of these Commands. 
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#DT4:<ABC.DAT/FB,ABC.TST/FB 



#DT4 : /FB< ABC . DAT , ABC . TST 

In the case of the paper tape reader, use of these switches guards against putting 
the tape in the reader backwards. For example, if the paper tape were in backwards, 
the command 

£SPRMAN . OB J< PR : /FB 

would cause PIP to print a S202 error message on the terminal. To transfer - 
ASCII cards from the card reader to disk or DECtape, the /FA switch must be used. 

3.1.5 Contiguous Files 

Contiguous files are handled differently from linked files. Blocks of contiguous 
files are guaranteed to be physically adjacent, whereas linked files are generally 
separated by a minimum fixed distance (called the interleave factor) to take 
advantage of the rotational delay inherent in a disk. Contiguous files are 
generally used for random accessing of data, a feature that is difficult with 
linked files. A contiguous file is noted in a directory listing by a C following 
the number of blocks for that file., 

Unless otherwise specified, file transfers will produce linked files. The /CO switch 
is used to specify an output file as contiguous. Three cases exist where use of 
the /CO switch is valid. All other uses of the /CO switch are invalid. The first 
two cases apply to a merge operation and a copy operation. For each operation, a 
new filename is specified in the output field of the command string. The /CO switch 
must be specified in the output side of the command string if the new file is to be 
created as a contiguous file, as shown below. 

1. A merge operation where the new file is to be made contiguous. 
For example, 

#SY:FILEME.RGE/C0<DK1:FIL1,DT1:FIL2 

2. A copy operation where the new file is to be made contiguous. 
For example, 

#SY : FILB/C0<DK1 : FILA 

NOTE 

In the case where the output file is explicitly named, the 
/CO switch must be on the output side. 
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In both of the preceding cases, it makes no difference whether the input file(s) is 
contiguous or linked. The output file must be designated contiguous with the /CO 
switch. 

The third case applies to 'a simple transfer operation where no new filename is 
specified explicitly but the new output file(s) is to be made or is to remain 
contiguous. In this case, the /CO switch must be given on the input side of the 
command string for the file(s) desired to be contiguous on the output device. For 
example, 

#SY : <DK1 :FIL1/C0 ,FIL2 ,FIL3/C0 

both FIL1 and FIL3 are created as contiguous files on the output device. FIL2 is 
created as a linked file, whether or not it is linked or contiguous. The same 
applies to the simplest case. For example, 

#SY:<DK1:FILA/C0 

FILA is created as a contiguous file on the output device. If the /CO switch is 
not used, FILA would be created as a linked file on the output device, whether or 
not it is linked or contiguous on the input device . 

3.1.6 Transfers from the Terminal 

Occasionally, the user may wish to transfer a file from the keyboard to another 
device. This is accomplished as follows. 

#PP:<KB: 

Subsequent characters typed at the keyboard are output to the high-speed paper 
tape punch. (Punching is performed in bursts as the tape punch buffer fills.) To 
indicate an end-of-file with such an operation (i.e., to stop transferring data to 
the punch), the DOS convention is to type CTRL/C followed by the END command. 

In order to execute the command, the terminal must be in Monitor mode. Consequently, 
the sequence is: 

tC (type CTRL/C) 

JEND (followed by the RETURN and LINE FEED keys respectively) 

The processing of the LINE FEED Key is necessary to force control back to PIP after 
the END command is executed. PIP returns with the # character when the above sequence 
is completed. 
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This same sequence is necessary when transferring from the low-speed paper tape 
reader. However, it is necessary to indicate the end-of-file from the user keyboard; 
the END PT command is given in this case. If the i user types 

#DF:FILEIN..MAC<PT: 

it is necessary to type 

+G (type CTRL/C) 

•ENDPT (followed by the PETURN key and LINE FEED key respectively; 

~ no colon is used after PT) 

after the tape has been read and the low-speed reader stops. 

Binary transfers are not allowed from the low-speed paper tape reader. The device 
is effectively the console, and the binary data input may contain control characters 
that will stop the data transfer. 

3.2 RENAMING FILES 

The rename switch allows the user a means of changing the name of a file. It may 
be used on either side of the command string. Only one file at a time can be 
renamed. If no device is specified, the system disk is assumed. For example, 

#MAIN . OB J/RE<TESTX . OBJ 
changes the name of the system disk file TESTX.OBJ to MAIN. OBJ. 
When renaming, it is mandatory that the same device be used on both sides of the 
angle bracket. The following is allowed. 

£DT:FILE1<FILE2/RE 
The device for FILE2 is assumed to be the DECtape. The sam*e command could be written 
as the following. 

£DT:FILEl : <DT :FILE2/RE 

3.3 DELETING FILES 

The delete switch is provided to allow the user a means of deleting one or more 
files. The simple form of the command consists of a file designator followed by 
the /DE switch. For example, 

£DT:MAIN.LDA/DE 

deletes the file MAIN.LDA from DECtape unit 0. 
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Several files can be deleted by specifying a sequence of filenames. before the 
DELETE switch. For example, 

#AB , DT : CD , DTI : EF . OB J/DE 

deletes three files on three different devices: SY:, DT:, DTI. 

The delete switch supports the asterisk in the filename and/or extension fields of 
the file specifications. The asterisk is interpreted as specified in Section 
12-2.5. For example, 

£DT1:*.LDA/DE 
deletes all files with the extension .LDA from DECtape unit 1. 

#*.*/DE 

deletes all files under the current UIC from the system disk. 

To delete all files from a DECtape, magtape, or cassette tape, it is recommended 
that the zero switch be used, since that operation is much faster (see Sections 
12-4.4.1 and 12-5.4). The zero switch must be used to delete files from magtape 
as no form of the delete switch is allowed in magtape processing. 

3.4 INSPECT SWITCH 

The inspect switch (/IN) is an auxiliary switch that instructs PIP to type out the ' 
name of each eligible file, followed by a question mark, before executing the main 
operation. The user can then perform the operation on that particular file, by 
typing a Y (for yes) followed by the RETURN key; or he may bypass the file by 
simply typing the RETURN key. 

In general, /IN is used with file transfers and with the /SU, /DE and /RE switches 
which is particularly useful when used in conjunction with asterisk-type commands. 
For example 

#*.*/DE/IN 
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allows the user to edit (accept or reject) the contents of a whole directory of the 
current UIC; for example. 



ABC. OBJ? Y ; Delete this file 

DEF.PAL? ;Do not delete this file 



etc. 

In the examples above, typing Y at the console caused the deletion of file ABC. OBJ. 
PIP listed another filename; the RETURN key was typed, file is left intact; PIP 
lists another file, etc. 

3.5 SUPERSEDE OPERATION 

When used on the input side of a transfer command, the supercede switch (/SU) causes 
any input file having the same name as a file on the output device to replace that 
output file. Input files not existing on the output device will simply be trans- 
ferred as usual. The /SU switch will not delete an output file if the input file 
to replace it is not present on the input device. In this instance, an S error 
condition will be given, and PIP will proceed to transfer any remaining files. 

The command is normally used in association with specific filenames specified only 
on the input side of the command string. 

#dev : <de vl : A , B , C/SU 

or for asterisk-type transfers, 

#dev:<devl:*.*/SU 

If the filename specification appears in the output side of the command string and 
the file already exists on the output device, the transfer is not made, and an 
S257 error occurs. 

In addition to its use as a stand-alone command, the supersede mode is invoked with 
a /SU:on command, which will remain in effect until the mode is turned off with a 
/SUtOFF, or until the program is killed. Enabling the mode in this way obviates 
entering a /SU switch following each command. 
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3.6 PROTECT SWITCH 

The protect switch is provided to allow the user to change the protection of a 
file. It is not applicable to cassette tape. 

The protection code is specified as an octal value argument to the switch and is 
treated as three fields corresponding to owner, user group, and all others. Each 
field is assigned an octal digit as described in the DOS/BATCH Monitor, Section 
3-4.2.2. The general form of this command follows. 

dev:filnam.ext/PR: value 
Example: 

£FILE3/PR:355 

This command changes the protection code of FILE3 to 355. The protection switch 
works for DECtape and disk. 

3.7 ALLOCATING A CONTIGUOUS FILE 

The allocate switch provides a means of creating a contiguous file. This option 
requires a filename and a decimal integer value (being the number of 64-word 
segments of storage to be allocated). For example, 

#DF:FILE/AL:10 

allocates 64/ contiguous words of file storage on the RF11 disk. A subsequent PIP 
command, 

#FILE<PR: 
causes a paper tape to be read into the contiguous file previously created. 

The allocate switch can be used to create a contiguous file on disk or DECtape. 
Note that the segments allocated are always 64 words and do not depend upon the 
block size of the device. For example, 

#DK0:FILE/AL:100 
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creates a blank contiguous file named FILE on device DK0. Since an RKll device 
contains 256 words per block, the allocated file contains 25 blocks, each 256 words 
in length. Each block contains four 64-word file segments. The number 25 followed 
by C is shown as the number of blocks of the file on the full directory listing 
for the device on which the contiguous file was created. For example: 

#DK0:FILE/DI *** 

DIRECTORY DK0: [200,200] 

24-AUG-72 

FILE 25C 24-AUG-72 <233> 

whenever it is necessary to create an empty, contiguous file, the identifier :E is 
appended to the command string. For example, 

#DF:FILEl/AL:10:E 

allocates 64^ contiguous words of file storage on the RF11 disk as normally. 
However, pointers are set in the UFD file entry such that the space is apparently 
empty. A file allocated in this manner can accept partial sequential output 
(through a Monitor .OPENC call) . The pointers are updated to reflect the end of 
the actual data entered in part of the allocated space. The same file can sub- 
sequently be extended (through a Monitor .OPENE call) within the unfilled allocated 
space. 

Use of the allocate switch allows data to be transferred from a non-file-structured 
device to the blank contiguous file. Without the allocate switch, it would be 
impossible for the sys*tem to determine the size of the file from a non-file- 
structured input device.. Data can also be transferred from a file- structured 
device to a blank contiguous file. However, allocation of the file space is not 
necessary, since the file-structured input device contains the necessary size 
information in its directory. (See the description of the /CO, contiguous, switch 
in Section 12-3.1.5.) 
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PART 12 

CHAPTER 4 

DIRECTORY MANIPULATION 

A significant number of PIP features center around the manipulation of files within 
directories and of the directories themselves. 

4.1 ENTERING USER IDENTIFICATION INTO THE MASTER FILE DIRECTORY 

The User Identification Code (UIC) must appear in the Master File Directory (MFD) 
before a user is able to create his own files on the disk or DECtape. This code is 
generally entered into the MFD by using the enter switch in PIP , although the DOS 
system building program creates a few fundamental User File Directories (UFD's). 
Refer to the DOS/BATCH System Manager's Guide for further details. 

The UIC of the current user of the system is passed to the operating syst.em by the 
LOGIN command. For example, 

$LOGIN 11,11 

sets the current UIC to [11,11]. In using the enter switch, the UIC of the current 
user is obtained from the system and written into a spare slot in the MFD. Here 
is the recommended sequence. 

$LOGIN uic 
£RUN PIP 
PIP Vxx 

#/EN 

The LOGIN UIC is now a valid UIC on the system disk. 

If no spare slots exist in the MFD, PIP prints a fatal error message, and no 
attempt is made to extend the MFD. 
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This procedure is not always necessary for DECtapes because the zero switch enters 
the UIC of the current user when the directory is initialized (see Section 12-4.4.1). 

If a user other than the one originally zeroing the DECtape wishes to access files 
on the tape, he must enter his UIC on the DECtape or explicitly reference the UIC 
field of the original user during each reference. For example, if the DECtape on 
unit 1 had been originally zeroed and filled by UIC [50,50], user UIC [200,200] 
could reference those files by logging in under [200,230] and by giving the following 
command . 

£DT1:/EN 

In general, then, an ENTER operation performs one of two services: for DECtapes 
it allows any user to access all files on the DECtape as though he had initialized 
the DECtape; and on disk it creates a UFD for the current (logged in) UIC (or the 
UIC specified) , allowing that user to store files on the system disk with whatever 
protection is desired. 

4.2 DIRECTORY LISTINGS 

A listing of the directory of all or certain selected files on any file structured 
device can be printed on the terminal or line printer; PIP assumes the terminal is 
the output device, unless another device is specified in the command string . The 
information listed in a directory is a subset of all the information in the UFD 
entry for each file. 

4.2.1 Full Directories 

A full directory (/DI) listing contains two title lines to identify the device, 
UIC, and the date, followed by all .filenames and extensions, the number of blocks per 
file (followed by a C if the file is contiguous) , file creation date, and file 
protection code (enclosed within angle brackets) , plus the total number of blocks 
and files for that UIC. See the example on the following page. 
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#/DI 

DIRECTORY DK0I [ 1,6 ] 

03-APR-74 

FORTRN.OBJ 
OV0 ,QBJ 



,OBJ 
,OBJ 
• OBJ 
t OBJ 



OV1 

0V2 

0V3 

0V<l ,ut}g 

FORUIB.OBJ 

EAEMOD.OBJ 

EISMOD.OBJ 

FISMOp.OBJ 

FPUMQD,OBJ 

EAEPC ,OBJ 

EISPC ,OBJ 

FISPC ,OBJ 

FPUPC t OBJ 

TRCUB.OBJ 

FORPC ,OBJ 

CQMDGN.SRC 

RUNDGN.SRC 

FORiIB.BAT 

FORPC t BAT 

EAEUIB.BAT 

EAEPC ,BAT 

EISUIB.BAT 

EISPC ,BAT 

FISUIB.BAT 

FISPC .BAT 

FPULIB.BAT 

FPUPC t BAT 

FORDGN.FTN 

TRACEF.FTN 

DVB ,MAC 

FQRCQM.DGN 

FORRUN.DGN 

TOTU BUKSf 
TOTl FIUESi 



72 
72 
82 

102 
95 
47 

167 

17 

18 

3 

31 

4 

4 

4 

4 

12 

4 

15 

14 



b 

8 

9 

21 

16 

837 
34 



20*FEB»74 
20-FEB-74 
20-FEB-74 
20*FEB-74 
20-FEB-74 
20*FEB*'74 
20«FEB*74 
20-»FEB«74 
20-FEB-74 
20-FEB*74 
20-FEB*74 
20-FEB-74 
20»FEB*74 
20-FEB-74 
20*FEB^74 
20-FEB-74 
20»FEB*74 
20-FEB-74 
20*FEB^74 
20*FEB*74 
20-FEB-74 
20*FEB*74 
20*FEB»74 
20*FEB*74 
20-FEB-74 
20«FEB*74 
20*FEB*74 
20*FEB-74 
20«FEB«»74 
20*FEB*74 
20-FEB*74 
20*FEB*74 
20«FEB-74 
20*FEB-74 



<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
«233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 



Notice that the system device (DK0: in this case) was' assumed and the user was 
logged in under UIC [1,6]. 

Whenever a file is transferred onto disk, cassette tape, or DECtape, the date in 
the directory reflects the date on which the transfer took place, not the date on 
which the file was created. 

The full directories of multiple devices can also be obtained. 
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£DK0:, DT1:/DI 

DIRECTORY DKO: C 4,2 3 



01-flPR- 


-74 




DIREC . 


LST 


98 


DIREC . 


OBJ 


13 


DIREC . 


, CRF 


15 


PI PI 




116 


PIP 


. LIB 


116 


DIREC 


. MAC 


32 


PIPEX 


. MAC 


35 


PIPEX 


. LST 


109 


PIPEX 


. OBJ 


C| 


PIP 


. LDfl 


31 


PIP 


. MRP 


9 



04--FEB-74 <233> 
04--FEB-74 <233> 
04--FEB-74 <233> 
04-FEB-74 <233> 
04-FEB-74 <233> 
04--FEB-74 <233> 
04--FEB-74 <233> 
04--FEI5-74 <233> 
04--FEI3-74 <233> 
04--FEI3-74 <233> 
04--FEB-74 <233> 



TOTL BLKS: 583 

TOIL FILES: 11 

DIRECTORV DTI: C 4, 3 3 

01-APR-74 

DUMMY ".MAC 3 01-RPR-74 <233> 

MTTEST. LDfl 11 Ol-flPR-74 <<£SS> 

TRNTST. LDfl 11 Ol-RPR-74 <233> 

FREE BLKS: 537 

FREE FILES:. 53 



When a full DECtape directory is obtained, the listing is concluded with the total 
number of free blocks and files, whereas with a disk, magtape, or cassette tape, 
the number of used blocks and files are reported. 

The full directory listing can be limited to produce a partial list of files on 
one or more devices. The following example illustrates the use of the asterisk 
to list only those files with the extensions specified on the two devices 
specified. 
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#DT1 : *. LDfi, DK0 : *. LIB, *. OBJ/DI 

DTI : 

C 4, 3 3 

MTTEST. LDfi 11 01-RPR-74 <233> 
TRNTST. LDfi 11 01-fiPR-74 <233> 

DKQ: 

C 4, 3 3 

PIP .LIB 116 04-FEB-74 <232> 
I 4, 2 3 

DIREC . OBJ 13 04-FEB-74 <2~:-;> 
PIPEX . OBJ S 04-FEB-74 <232> 



Notice that the UIC, date, and number of blocks and files for that UIC are not 
reported in partial /DI listings. 

Directory information about a particular file can be obtained by specifying the 
filename and extension with the /DI switch. For example: 

#PIPEX. OBJ/DI 

DKO: 

C 4, 3 3 

PIPEX .OBJ 9 04-FEB-74 <232> 

# 



This obtains all information about PIPEX.OBJ if it is in the DK0 directory. 

(If the file is not in the directory, there is no listing, and no error message.) 

A directory of any UIC on any device can be listed by specifying that UIC in the 
command to PIP. For example, if a user is logged in under UIC 200,200, he can 
give the following command (the results are shown on the following page) . 
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#DK1: [100, 32] /DI 
DIRECTORY DK1 1 [100,32! 3 



03*APR"74 



KNIGHT 


,odl 


ADL 


,ODL 


MAIN 


.FTN 


ADL1 


,FTN 


ADL2 


• FTN 


A2A 


,FTN 


A2B 


,FTN 


A3A 


»FTN 


A3B 


,FTN 


A4A 


• FTN 


A4B 


• FTN 


ADL 


• BUD 


ADUDKUBLD 


A3A 


,OBJ 


A3B 


,OBJ 


A4B 


.OBJ 


OVRLY 


,OBJ 



317-JAN-74 

H-JAN-74 

n-.MN-7a 

17-JAN-74 
17-JAN-74 
I7-JAN-74 
17-JAN-74 
17*JAN-74 
17-JAN-74 
17-JAN-74 
i7"JAN»74 
17-JAN-74 
17-JAN-74 
17-JAN*74 
17-JAN-74 
17-JAN-74 
17-JAN-74 



<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 
<233> 



TOTL BLKSl 
TOTL FILES! 



19 
17 



If the user requests information on any particular file or uses the asterisk feature 
where no such file exists, no error message is given. The directory is considered 
blank; and a blank line is printed. 

#DK9 : *. OBJ, DTI : *. GBJVDI 
DKQ: 



C 4, 3 3 

DIREC . OBJ 
PIPEX . OBJ 

DTI: 

C 4,3 3 

# 



13 04-FEB-74 <233> 
9 04-FEB-74 <233> 
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4.2.2 Brief Directory Listings 

The brief directory (/BR) switch can be used to list only the device name, file- 
names, and extensions. The asterisk feature or specific filenames can be used 
with the brief directory switch to obtain partial brief directories. 

The following PIP example demonstrates the correspondence between /DI and /BR 
directory listings. 

£*.LDA/DI 

D I K L L T U K Y U i\ «U £ i t 1 J 
18-MAP-74 



bAUrj 


tST8 


1 


itf»Ptb-74 


<377> 


Mui'iLU 


i»ClL 


i/SC 


19-f' fcfct-7 4 


<3/7> 


3YSMAC 


;#aH U 


i*r> 


iftt-^" tb-?4 


<*od> 


L.UUMP 


• UUA 


S29 


k ui - f* £ ft - 7 4 


<23;j> 


CUi 


.3Yb 


I 


^-►felWA 


< 2 d 3 > 


tLl 


t S > S 


1 


i!(/j-p|-tB"74 


<233> 


CL2 


• SYS 


1 


*fes*F.fcb*7 4 


<233» 


CL4 


.SYt? 


1 


^^-l-fc.H-74 


<233> 


LU4 


• $>S 


I 


2 tf - 1" t ft » 7 4 


<2od> 


CLO 


• 3 Y S 


1 


^j-fLft*^ 


«233> 


CL& 


.SYS 


1 


ii if "PLB-7 4 


<233> 


CL7 


t S 1 3 


1 


'dki<*1r£b-74 


<233> 


UKfcSLU 


• til A ( 


2 


i«M-i'tft*74 


<2^3> 


UKbl.Uh 


• BM 


A 


fcwttb-74 


<23.:5> 


t" "1 K 1 1 1 


• HAT 


Z 


*0«hfcB-74 


<is1s5> 


CTKllg 


« B A i 


9 


kt<,-F£b»74 


<2iv>> 


CTStb 


.BAT 


■9 


2tf-M:b«74 


<2^> 


ctsaV 


• s a r 


6 


SAi-Ffc.b-74 


<^»53> 


CTHtS 


.bAi 


4 


«i^»»*Lb-? , 4 


■<£.33> 


CTMTP 


• BAT 


6 


2l/s»Ffc.B»74 


<£3v>> 


CTttLul- 


• p a j 


4 


«. tj "> F- fc b » 7 4 


<S3 t i> 


CTSaVP 


■ MAI 


4 


«e:fe."-Pfcb""74 


^2do> 


CTKt'SK 


• b a i 


2 


fc|fl-KE&*7 4 


<fe03> 


MULCT 


• 6A| 


i 


fcW-PfctW4 


<233> 


PV*i \ \ 


• BAT 


9 


kw^tb-74 


<25o> 


P 1 M 1 2 


• HMl 


5 


i£W«Ffcb->7 4 


<23^> 


PTBLU 


• B A "{ 


2. 


ie-lo-l-fc.H-74 


<203> 


PTSA.v 


tbAI 


2 


^t^fkft-74 


<233> 


PfKtb 


• 6A1 


1 


^lv-Ptft-74 


<233> 


P T M 1 P 


.BAi 


4 


fctr-l-tB-74 


<2*53> 


P TftLUF 


• ft A i 


4 


2 if"* 1" fc. ft * 7 4 


«233> • 


PT5AVH 


• dAi 


1 


kJk'-PfeB-/« 


<23d> 


PTKfc&F 


. b a t 


2 


fc0»FLtS»74 


<2T53> 


MUL.PT 


• BAT 


2 


*i/<*Ftb-74 


<20sj> 


UQJ 


• Ob j 


IV 


*i'-f-tb-7 4 


<203> 


LINN . 


• LMA 


37 C 


£b~tt-b-?4 


<203> 


FOHITKN, 


.L^A 


i>4 


\c> a m h A 8 ■" 7 4 


<23v5> 


FOPCUH, 


, U N . 


*iC 


b 4 » ft A K - 7 « 


<i!<iS> 


1 •'• A L M U , 


• LUA 


<W 


* b » F fc ft - 7 A 


<?.di> 


■ CKtF' 


..LUA 


1 fc 


<:e?-i-Lb-74 


< r i'66> 


PIP 


pLUA 


45L 


* fc « i- 1 ft - 7 4 


<£'<i$> 


CILuS , 


.LUA 


jy 


* b ~ F L b •> 7 4 


*'iJH>> 


to IT , 


,LUA 


13 


SSfc-Ffcb-74 


<2^3> 


FiLuHP, 


• LwA 


7 


( <;f;'"h'tb«7 4 


<2'o6> 


USMNT i 


'Li.' A 


y 


^fc-Ffc.fc-74 


<*AA> 


LlbK , 


■ Li.' A 


9 


*b-ffcfc)-7<» 


<2JJ!>> 
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tHA5Ll.i.i>A 
VtKJ> Y , LUA 

pl'iHKUM.nUN 

TKCi.lb.uOs> 



1 O'f L. HUoi D<i 



£*.LDA/BR 



b A u n 


,!>Yb 


Mt'NLXb 


• CAL 


SvSwAC 


• SrtL. 


LOdrtP 


• U U ft 


CLtf 


.SY6 


tui 


.SYS 


CL2 


. S t i 


cto 


• s/s 


CU4 


• SYJj 


cu*> 


.STfa 


cl& 


.STi? 


CU 


. S » S 


UKtitU 


* BH 1 



C T M T 1 . H A T 

CTrtLU •««! 
C T & A V , U A | 

C I ' K t * • y A 7 

CTM1> «ttAT 
CTtJUUf-.BAl 
t T S A V ^ , b A T 
CTtf'fcfce •&*!' 

PTMTltwAl 
PTK112.BA1 
PTbLW *bA« 
PTSAV .&*! 
HIKt* «BAI 
PTMlh.BAI 
PlbUi^ -BA I 
P13AVI- .6A1 
PTRfcbf «>HAl 
MtLPToBAi 
OUT «0dJ 

LINK „LUtt 
FUHTRN.L^a 
FOKCuru QisH 

MACHU «LUA 

CKfeF »U'A 

P 1 H « L I/' A 

C1LU& pLL-A 



1* 


<!fc-h tf-7A 


«iM3» 


6 


fcfc-t-fctWd 


<ii«J>i> 


(?;c 


*b-i- ttf-7" 


<233> 


il 


* f, - Y 1 1) » 7 4 


<2.*4> 


16C 


t"4«hAk-7<a 


<2«i^> 


joy 


t d - h A K - 7 4 


<230> 


i? 


t<i*fiAK"'74 


<2»4> 


■libt 


t* 4 •» i i A K ■» 7 4 


<26i> 
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Lib* .{.ua ' 

Vt-Kl* Y,U r A 
I* T U T 1 1 9 L i> A 
F U K K U N • O b N 
FTNtiB.OoJ 
TrtCLlbtOtiJ 
P'jKTkn»0'v> 

An example of the /BR switch with the system device assumed is shown below. 

#/BR 

DK0I 

t 1#5 ) 

PIP16 ,tDA 
EDim.lDA 
LNK256,L0A 
VER256 t LDA 
CJLUS v i.IB 
LINK ,HB 
LINK ,QDL 
LNKNOVtBAT 
LNKQV .BAT 
MACRO .UIB 
MACRO t 0Dl 
MACNQV.BAT 
VERIFY, LIB 
VERIFY, QDl. 
VERNOV.BAT 
VEROV ,BAT 
PIP .LIB 
PIP ,'OOL 
PIPNOV.BAT 
CUSP ,L,IB 
FIU0M.BAT 
DSKINT,BAT 
EBASCI.BAT 
EDIT ,BAT 
LIBR ,BAT 
FH.DMP.BAT 
CREF ,BAT 

The asterisk (*) feature for filenames and extensions works for directory listings, 
both full and brief form. For example, the command 

£*.PAL/BR 

gives a brief directory listing for all files on the user's disk area with an 
extension of .PAL. The asterisk can appear in the filename field, the extension 
field, or both. In addition, groups of file specifiers can be arranged to provide 
sequential listings. 

12-27 



#DT0 : * . MAC , DF : FORTRN . */DI 
The asterisk feature can be used in the UIC field when obtaining directory listings. 

#LP:<DK:[*,*1/DI 
All directories on KKll unit are listed on the line printer. 

#LP:<DF:[*,200]/DI 

A listing is produced of all directories associated with user number 200, in every 
project. 

#LP : <DK: * . MAC [* , * ] /DI 

A directory of all files with extension .MAC, on RKll unit 0, is produced. 

4.3 FREE BLOCKS 

Since a full directory listing of a system disk provides the user only with a 
summary of the number of blocks used by his current UIC, the /FR switch is available 
for determining the number of free blocks remaining . For example : 

#/FR 

DF0: 

FREE BLKS: 5513 

This switch can be used with any file-structured device, but is generally only 
necessary with disk, as the information is provided automatically with a DECtape. 
Further examples of the /FR switch follow. 

#/FR 

DK0 : 

FREE BLKS: 4113 

#_DP: ,DT0:/FR 

DF0: 

FREE BLKS:: 3243 

DT0 

FREE BLKS: 282 
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4.4 DECTAPE AND RKll DISK INITIALIZATION 

(See Chapter 12-5 for magtape initialization and Chapter 12-6 for cassette initiali- 
zation.) 

4.4.1 DEC tape 

In order to initialize a new DECtape with the basic file structure information 
required by the DOS/BATCH Monitor, the zero switch is provided. The zero switch 
causes PIP to create On the specified DECtape the permanent bit maps, the file bit 
maps, the MFD, and a UFD for the UIC currently running on the system. The zero 
switch can be used alone, 

#DT0:/ZE 

or in combination with other actions. 

#DT0 : 0NE/ZE<DT1 : A , B , C 

The latter command zeroes DT0: first, then creates file ONE on DT0: by merging 
files A, B, and C from DECtape unit 1. When used in combination with other actions, 
zero is performed before any other implied actions. 

The /ZE switch can be used to zero only one DECtape per PIP command string. In 
order to zero two DECtapes, proceed as follows. 

#DT:/ZE 
£DT1:/ZE 

4.4.2 RKll Disk 

Before initializing an RKll cartridge with the zero switch, ensure that the cartridge 
has been formatted using either the RKll diagnostic program (MAINDEC-11-D5HA-PB2) 
or the SYSLOD system program. Consult the system administrator for local procedures. 
The following actions occur during cartridge initialization. 

1. The entire disk cartridge is zeroed. 

2. The first and second MFD blocks are written. 

3. The UIC of the current user (and only this UIC) is entered in the MFD. 

4. Bit map blocks are written. 
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An RKll disk is initialized by typing 

|DKn:/ZE 

where n is the octal number of the appropriate cartridge (or omitted if DK0 is 
meant) . PIP responds by printing 

CONFIRM: 

to which the user should type either H (for high-density) or L (for low-density) 
followed by the RETURN key. Should the user decide not to initialize the disk, 
he types the SPACE bar before pressing the RETURN key. (High-density cartridges 
are marked 2200 BPI, and low-density cartridges are marked 1100 BPI.) 

When the disk has been initialized (there is a noticeable pause) , PIP again prints 
the # character to indicate readiness to accept another command. 

4.5 RECOVERING FILES 

A file can be left in a state that makes it inaccessible for subsequent processing. 
For example, if a file is open for output and a system crash (hardware or software) 
occurs causing the Monitor to be reloaded, the file may be left in an inaccessible 
state. Files declared inaccessible by the Monitor can have any of the following 
conditions . 

1. The LOCK bit in the UFD entry for this file will be set. 

2. The USAGE COUNT in the UFD entry for this file will be invalid. 

3. Some blocks allocated for this file may not have the proper 
bits set in the permanent bit map. 

PIP provides a partial solution to this problem with the unlock switch. The 
function of this switch is to restore the lock and usage count fields so that the 
file can be read. It does not make an attempt to set bits in the bit map for the 
blocks . 

The sequence for recovery is to use the unlock switch, such as 

$RUN PIP 
PIP Vxxx 

#DF: FILE. OLD/UN 

which allows the file to be accessed. 
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Then, before writing any new data on the disk copy the file to another device 
and delete it from the disk. 

#DT:<FILE 
#FILE/DE 

Copy, then delete all files that were open for output when the crash occurred. The 
disk may then be used safely. 
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PART 12 

CHAPTER 5 

MAGTAPE OPERATION 



5.1 GENERAL MAGTAPE INFORMATION 

Magnetic tape is supported by PIP for the following operations. 

a. Directory listings. 

#MT1:/DI 
#MT0:/BR 

b. File transfer operations (a magtape reel must be initialized before 
any files are transferred to the reel for the first time. See 
Section 12-5.4 for the initialization procedure) , 

#MT1 :FILE<DT2 :ABC 
#MT:MERGE<ABC,DT0: FACT, MT1: DATA 

c. Magtape initialization (see Section 12-5.4). 
#MT1:/ZE 

d. Rewind, rewind suppression, and rewind and unload (see Section 
12-5.2 and 12-5.3). 

Transfer and directory operations include all asterisk features used for other 
file-structured devices. For example, it is possible to type either of the 
following. 

#MT1:[*,*]/DI 



#MT1: [*,*]/BR 

This allows the user to obtain a complete listing of all files on the specified 
magtapes. When this option is used, the UIC specification is. printed as part of 
the file information. 

5.2 REWIND 

The rewind switch is applicable to magtape units (MTn) and cassette drives (CTn) 
only, and controls rewind operations for one or more specified units. The specified 
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unit(s) can still be addressed after use of the rewind switch. The specifications 
/RW and /RW:YES cause the specified unit(s) to be rewound; the specification 
/RW:NO prevents rewinding of the specified unit(s). 

Examples: #MT1:/RW 

causes magtape unit 1 to be rewound. 

#DK0 : <MT2 : * . */RW : NO 

causes all files under the current UIC on magtape unit 2 to be 
transferred to disk without rewinding magtape unit 2 between 
file transfers . 

#DK0 : <MT1 : F ILE . ONE/RW : YES 

causes magtape unit 1 to be rewound before and after transferring 
FILE. ONE to disk 0. 



#MT0:<MT1:FILE1,FILE2 



causes MT0 and MTl to be rewound before and after each 
transfer. 



£MT0:/RW:NO<MT1:FILE1,FILE2 



will cause MTl to act the same as the preceding example. MT0 in this 
case will not rewind. 



#MT0:/RW:NO<MT1:FILE1/RW:NO,FILE2 



will cause MT0: to act as in the preceding example. MTl will not be 
rewound before or after the access of FILEl, but MTl will be rewound 
on access to FILE 2. 



£MT:/RW:NO 

inhibits rewinding on magtape unit for all subsequent operations. 

#MT:/RW:YES 

enables rewinding on magtape unit for all subsequent commands. 

If the rewind switch is not specified for an operation, a default value of /RW : YES 
is assumed. 
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5.3 REWIND /UNLOAD 

The rewind/unload switch is applicable only to tape units. This switch causes the 
tape to be wound back and the tape unit to be switched off-line. Following this 
option, the affected tape units cannot be addressed for further processing. For 
example : 



#MT:/RU 



£MT2:,MT3:/RU 

5.4 ZERO (INITIALIZATION) 

It is mandatory that a magtape be zeroed before use., The /ZE switch writes two 
end-of-file marks on the tape so that it can be handled correctly by the system 
monitor. For example: 

£MT2:/ZE 

Zeroes (initializes) MT2 (magtape unit 2) . 

5.5 MAGNETIC TAPE FORMAT 

All files on magnetic tape have the general format, exclusive of data format, as 
shown in Figure 12-1. Any file on the tape may be retrieved by name. 
LOAD POINT OF EOF 



RECORD 1 
RECORD 2 
RECORD 3 



RECORD n-1 



RECORD n 



FILE LABEL 



DATA 



DATA 



DATA 



EOF 



7 words 



256 words 



256 words 



256 words 



Figure 12-1 
Magtape General Format 
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PART 12 

CHAPTER 6 

CASSETTE TAPE OPERATION 

6.1 GENERAL CASSETTE TAPE INFORMATION 

Cassette tape is supported by PIP for the following operations. 

a. Directory listings 

#CT0:/BR 
#CT:/DI 

b. File transfer operations (a cassette tape must be initialized before 
any files are transferred to the tape for the first time; refer to 
Section 12-6.3 for the initialization procedure) . 

#CT : SOURCE . MAC<DK : MACRO . MAC 
£CT:MERGE.MAC<CTl:FILEl.MAC,DKl:FILE2.MAC 

c. Cassette tape initialization (refer to Section 12-6.3) 
#CT:/ZE x 

d. Rewind specifications (refer to Section 12-6.2). 

#CT:/RW 

#CT : /RW : NO<CTl : * . */RW : NO 

e. Read-after-write-verification (refer to Section. 12-6.5) . 
#CT : /VW<CT 1 :F ILE . MAC 

The transfer and directory operations include all asterisk features used for other 
file-structured devices. This allows the user to obtain a complete listing of all 
files on the specified cassette. 

6.2 REWIND 

The rewind switch is applicable only to cassette (CTn) and magtape (MTn) drives. 
This switch causes the tape to be rewound back onto its original reel. Following 
this operation, the cassette units still can be addressed. The following are 
examples . 
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#CT1:/RW 
#CT0:,MTl:/RW 

The rewind switch enables rewinds during the specified cassette operation. The 
following example rewinds CT1 before seeking the file specified for the transfer 
operation . 

#DK0 : <CT1 : FILNAM . EXT/RW : YES 

The rewind switch also can be used to suppress rewinds during the specified cassette 
operation. For example, 

#DK0:<CT1 : * . */RW:NO 

transfers all files onto the disk without rewinding CTl. 

6.3 ZERO (INITIALIZATION) 

A cassette must be zeroed before using the /ZE switch. The /ZE switch writes a 
sentinel label record on the tape which enables proper handling by the Monitor. 
The following example, 

#CT1 : /ZE 

zeroes (initializes) CTl. 

6.4 CASSETTE TAPE FORMAT 

All files on cassette tape have the general format, exclusive of data format, shown 
in Figure 12-2. Any file on the tape can be retrieved by name. 
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BOT,OR EOF' 
RECORD 1 

RECORD 2 
RECORD 3 



RECORD n-1 



FILE LABEL 



nATA 



DATA 



DATA 



EOF 



16 words 

64 words 
64 words 



64 words 



Figure 12-2 
Cassette General Format 

6.5 READ-AFTER-WRITE VERIFICATION 

Throughout the transfer, after writing each record, the cassette is backspaced and 
the record is read and verified against the contents of the user's buffer. 
Notification of verification failures are printed on the operator's console as 
either 1100 or F076 error diagnostics. 



*BOT refers to the beginning of tape; EOF refers to the end of the previous file, 
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PART 12 

CHAPTER 7 

HELPFUL HINTS 

There are some techniques familiar to experienced DOS/BATCH users, but the beginner 
often has to learn them empirically.. This chapter is meant to help the beginner 
avoid some common pitfalls. 

1. N If you are having difficulty running PIP, make sure that 

a. You did a KILL command after running the last program prior to 
running PIP. 

b. The PIP load module is on the disk. 

c. You are accessing the proper UIC field on the DECtape, if attempting 
to run from DECtape. 

2. If you are having difficulty accessing a file that you are positive 
is there, you are probably logged in under a different UIC than 
appears on the device. In this case, either 

a. Explicitly specify the UIC in the command. 

b. FINISH and LOGIN under the proper UIC. 

c. ENTER your UIC on the device (See Section 12-4.1) . 

3. If you are having difficulty transferring to the line printer, make 
sure the printer is on-line; set the switch to ON LINE. 

4. If you are having difficulty reading a file and there has recently been 
a software or hardware crash, read Section 12-4.5, Recovering Files. 

5. If you continue to get file structure errors on output files, you 
are probably trying to create a file which already exists. The 
system does not allow this, so delete the file first or use the 
supersede (/SU) switch, 

6. If you are logged in for the very first time and cannot create any 
files, it is because you have no User File Directory (UFD) in the Master 
File Directory (MFD). To create one, log in, call PIP, and type 

#SY:/EN 
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7. If you cannot write anything on a DECtape even though the WRITE switch 
is on, it is likely that 

a. Your UIC is not entered on the DECtape (see Section 12-4.1). 

b. The tape has not been certified. 

Uncertified DECtapes can be certified using a diagnostic program (TCll 
DECtape Formatter MAINDEC-11-YPTB-PB) supplied with the maintenance 
programs. 

8. Use of the /RW:NO option when transferring files from magtape and 
cassette can save much time normally lost during a rewind operation. 

9. If experiencing trouble with transfers from the card reader, check to 
ensure that (1) control cards are compatible with the card reader 
type, and (2) end-of-file cards are compatible with the current 
version of the Monitor. 



12-39 



